<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
		<link rel="Stylesheet" type="text/css" href="doc.css" />
		<title>Workspace Integration Example</title>
	</head>
	<body>
		<h1>Workspace Integration Example</h1>

		<h2>Introduction</h2>
		<p>
			This example describes the usage of the transaction framework through the workspace
			integration. It demonstrates how a UI could be hooked up using the eclipse operation
			history framework to allow UI and non-UI threads to read and make changes to a
			transactional editing domain.
		</p>

		<h2>References</h2>
		<p>
			Please refer to the document <a href="exampleOverview.html">EMF Model Transaction Examples Overview</a>
			for reviewing the library meta-model used as the basis for demonstrating the capabilities in this example.
		</p>

		<h2>Description</h2>
		<p>
			This example plug-in is named <code>org.eclipse.emf.workspace.examples.library.editor</code>.
			This plug-in contributes a new EXTLibrary editor for opening and modifying existing library
			files:
			<ol>
				<li>
					An editor is opened for each resource. The editor only shows one resource. When other
					resources are loaded (eg. proxy resolution causes anothe resource to be loaded) into the
					editing domain, another editor is opened for that resource.
				</li>
				<li>
					The undo/redo of each editor is governed by an IOperationHistory and only the operations
					that affect the resource are presented in that menu.
				</li>
				<li>
					<b>Example Background Task:</b> This actions performs a read task in the background to
					demonstrate how the UI can be blocked for making changes while this read task is in progress.
				</li>
			</ol>
		</p>

		<p>
			Please refer to the tutorial <a href="../../tutorials/workspaceTutorial.html">Workspace Integration Tutorial</a> 
			for reviewing the code samples within this example
		</p>

		<img src="workspaceGeneral.gif" alt="Workspace Example Editor" />

		<h2>Usage</h2>
		<p>
			Refer to this example if you need:
			<ol>
				<li>Multiple editors sharing the same editing domain</li>
				<li>Integration of a transactional editing domain into the eclipse IOperationHistory</li>
				<li>Management of multiple read/write threads on a single EMF-style editing domain</li>
			</ol>
		</p>

		<hr />

		<p>
			<a href="https://www.eclipse.org/legal/epl-2.0/">Copyright (c) 2006 IBM Corporation and others.</a>
		</p>
	</body>
</html>
